Skip to content

feat: status 기반 소크라테스 clarification gate와 repair loop 안정화#102

Merged
alexization merged 3 commits into
mainfrom
codex/status-clarification-gate-v3
Apr 17, 2026
Merged

feat: status 기반 소크라테스 clarification gate와 repair loop 안정화#102
alexization merged 3 commits into
mainfrom
codex/status-clarification-gate-v3

Conversation

@alexization
Copy link
Copy Markdown
Owner

@alexization alexization commented Apr 17, 2026

Summary

  • Harness spec 승인 게이트를 coverage category 기반 검사에서 Status: open|resolved 기반 clarification gate로 전환했습니다.
  • open clarification이 남아 있으면 approve가 실패하고, status는 readiness와 open/resolved 집계를 함께 노출하도록 바꿨습니다.
  • review feedback으로 확인된 pre-v3 locked intake 회귀를 보정해 legacy task도 status, plan, doctor 경로에서 정상적으로 읽히도록 했습니다.
  • reopen 시 target phase뿐 아니라 downstream phase까지 pending으로 되돌리도록 repair loop semantics를 보강했고, 과거 task artifact는 정리해 현재 harness task만 남겼습니다.

Linked Issue

How

  • clarification parser, locked intake schema, approve/status runtime을 question/answer/decision/status 모델로 단순화하고 contract_version = 3으로 올렸습니다.
  • contract_version < 3 task는 legacy resolved clarification schema를 loader/consistency 경계에서 status 기반으로 정규화하도록 보강했습니다.
  • new 템플릿, AGENTS, docs, workflow-local skills, CLI 테스트를 새 clarification contract와 reopen semantics에 맞춰 함께 갱신했습니다.
  • repair loop 중 earlier phase를 다시 열면 뒤 phase 상태도 무효화되도록 reopen 로직과 회귀 테스트를 추가했습니다.
  • workflows/tasks/에서는 task-harness-socratic-uncertainty-gate만 남기고 나머지 과거 task artifact를 제거했고, review follow-up verification evidence를 다시 남겼습니다.

Validation Summary

  • python3 -m unittest tests.test_workflow_cli -v
  • legacy locked intake compatibility targeted tests 추가 및 통과
  • python3 scripts/workflow.py doctor
  • python3 scripts/workflow.py status --all --check
  • task-harness-socratic-uncertainty-gate를 reopen 후 phase-1/phase-2 verification까지 다시 태워 현재 review_ready 상태를 확인했습니다.

Reviewer Focus

  • pre-v3 locked intake normalization이 v3 strict validation을 약화시키지 않고 legacy task만 호환시키는지
  • reopen 시 downstream phase reset과 follow-up verification evidence가 실제 repair loop semantics와 맞는지
  • task artifact cleanup 이후에도 current canonical task surface와 consistency check가 유지되는지

Impact / Risks

  • 새 라이브러리, 외부 서비스, 스키마, 설정, 환경 변수, 마이그레이션: 없음
  • 사용자나 운영에 영향이 있으면 적어 주세요: 다음 task부터는 열린 clarification이 남아 있으면 spec 승인과 후속 phase 진행이 차단되고, 기존 pre-v3 task도 즉시 깨지지 않고 재승인 경로로 들어갈 수 있습니다.
  • 배포, 롤백, 커뮤니케이션 시 주의점이 있으면 적어 주세요: 이전 coverage 기준으로 이해하던 운영 문맥은 더 이상 유효하지 않으므로 새 Status: contract를 기준으로 봐야 합니다.
  • 남아 있는 리스크와 후속 작업: current task는 review follow-up까지 반영해 review_ready로 복구됐고, 최종 completed closeout에는 다시 explicit user validation이 필요합니다.

- status 기반 open/resolved clarification contract와 intake/status gate를 v3로 전환
- reopen 시 downstream phase까지 pending으로 되돌리도록 runtime과 회귀 테스트를 보강
- docs, skills, workflow task artifact를 새 contract와 cleanup 범위에 맞춰 정리
@alexization alexization marked this pull request as ready for review April 17, 2026 04:23
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ff7d096d80

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/workflow_runtime/models.py Outdated
- legacy clarification intake가 status 없이도 load, plan, doctor 경로에서 정규화되게 보정
- pre-v3 task의 locked intake 회귀를 막는 CLI 테스트를 추가
- review feedback에서 지적된 loader 회귀를 phase-1 범위에서 수정
- legacy intake compatibility 수정 이후 phase-1/phase-2 verification evidence를 다시 기록
- task-harness-socratic-uncertainty-gate를 review_ready 상태로 복구
- follow-up repair loop의 kickoff, verification, review run artifact를 남김
@alexization alexization merged commit 13ba682 into main Apr 17, 2026
1 check passed
@alexization alexization deleted the codex/status-clarification-gate-v3 branch April 17, 2026 04:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: status 기반 소크라테스 clarification gate와 repair loop 안정화

1 participant